'\" te
.\" Copyright (c) 2008, Sun Microsystems Inc. All Rights Reserved.
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
.TH GETLABEL 1 "Jul 11, 2008"
.SH NAME
getlabel \- display the label of files
.SH SYNOPSIS
.LP
.nf
\fB/usr/bin/getlabel\fR  [\fB-sS\fR] \fIfilename\fR...
.fi

.SH DESCRIPTION
.sp
.LP
\fBgetlabel\fR displays the label that is associated with each \fIfilename\fR.
When options are not specified, the output format of the label is displayed in
default format.
.SH OPTIONS
.sp
.ne 2
.na
\fB\fB-s\fR\fR
.ad
.RS 6n
Display the label that is associated with \fIfilename\fR in short form.
.RE

.sp
.ne 2
.na
\fB\fB-S\fR\fR
.ad
.RS 6n
Display the label that is associated with \fIfilename\fR in long form.
.RE

.SH EXIT STATUS
.sp
.LP
\fBgetlabel\fR exits with one of the following values:
.sp
.ne 2
.na
\fB\fB0\fR\fR
.ad
.RS 5n
Successful completion.
.RE

.sp
.ne 2
.na
\fB\fB1\fR\fR
.ad
.RS 5n
Unsuccessful completion due to usage error.
.RE

.sp
.ne 2
.na
\fB\fB2\fR\fR
.ad
.RS 5n
Unable to translate label.
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp

.sp
.TS
box;
c | c
l | l .
ATTRIBUTE TYPE 	ATTRIBUTE VALUE
_
Interface Stability 	See below.
.TE

.sp
.LP
The command line is Committed. The output is Not-an-Interface.
.SH SEE ALSO
.sp
.LP
.BR setlabel (1),
.BR m_label (3TSOL),
.BR label_encodings (5),
.BR attributes (7)
.SH NOTES
.sp
.LP
The functionality described on this manual page is available only if the system
is configured with Trusted Extensions.
